home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 25 / AACD 25.iso / AACD / Magazine / Online / QMail / man / cat8 / qmail-command.0 < prev    next >
Encoding:
Text File  |  1997-09-21  |  3.3 KB  |  67 lines
  1.  
  2.  
  3.  
  4. qmail-command(8)                                 qmail-command(8)
  5.  
  6.  
  7. NNAAMMEE
  8.        qmail-command - user-specified mail delivery program
  9.  
  10. SSYYNNOOPPSSIISS
  11.        in ..qqmmaaiill_e_x_t: ||_c_o_m_m_a_n_d
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        qqmmaaiill--llooccaall  will,  upon  your request, feed each incoming
  15.        mail message through a program of your choice.
  16.  
  17.        When a mail message arrives, qqmmaaiill--llooccaall runs sshh  --cc  _c_o_m_-
  18.        _m_a_n_d  in your home directory.  It makes the message avail-
  19.        able on _c_o_m_m_a_n_d's standard input.
  20.  
  21.        WWAARRNNIINNGG:: The mail  message  does  not  begin  with  qqmmaaiill--
  22.        llooccaall's usual RReettuurrnn--PPaatthh and DDeelliivveerreedd--TToo lines.
  23.  
  24.        Note  that  qqmmaaiill--llooccaall  uses the same file descriptor for
  25.        every delivery in your ..qqmmaaiill file, so it is not safe  for
  26.        _c_o_m_m_a_n_d  to  fork  a  child  that reads the message in the
  27.        background while the parent exits.
  28.  
  29.        _c_o_m_m_a_n_d's exit codes are interpreted as follows:  0  means
  30.        that the delivery was successful; 99 means that the deliv-
  31.        ery was successful, but that qqmmaaiill--llooccaall should ignore all
  32.        further delivery instructions; 100 means that the delivery
  33.        failed permanently (hard error); 111 means that the deliv-
  34.        ery  failed  but  should  be tried again in a little while
  35.        (soft error).  Currently 64, 65, 70, 76, 77, 78,  and  112
  36.        are  considered  hard errors, and all other codes are con-
  37.        sidered soft errors, but _c_o_m_m_a_n_d should avoid  relying  on
  38.        this.
  39.  
  40.        qqmmaaiill--llooccaall  supplies several useful environment variables
  41.        to  _c_o_m_m_a_n_d.   SSEENNDDEERR  is  the  envelope  sender  address.
  42.        NNEEWWSSEENNDDEERR  is  the  forwarding envelope sender address, as
  43.        described in  ddoott--qqmmaaiill((55)).   RREECCIIPPIIEENNTT  is  the  envelope
  44.        recipient  address,  _l_o_c_a_l_@_d_o_m_a_i_n.  UUSSEERR is _u_s_e_r.  HHOOMMEE is
  45.        your home directory, _h_o_m_e_d_i_r.  HHOOSSTT is the _d_o_m_a_i_n part  of
  46.        the  recipient  address.  LLOOCCAALL is the _l_o_c_a_l part.  EEXXTT is
  47.        the ..qqmmaaiill extension, _e_x_t.  EEXXTT22 is  the  portion  of  EEXXTT
  48.        following  the  first  dash; EEXXTT33 is the portion following
  49.        the second dash; EEXXTT44 is the portion following  the  third
  50.        dash.   DDTTLLIINNEE  and  RRPPLLIINNEE are the usual DDeelliivveerreedd--TToo and
  51.        RReettuurrnn--PPaatthh lines,  including  newlines.   UUFFLLIINNEE  is  the
  52.        UUCP-style FFrroomm__ line that qqmmaaiill--llooccaall adds to _m_b_o_x-format
  53.        files.
  54.  
  55.        WWAARRNNIINNGG:: These environment variables are not quoted.  They
  56.        may  contain  special characters.  They are under the con-
  57.        trol of a possibly malicious remote user.
  58.  
  59. SSEEEE AALLSSOO
  60.        dot-qmail(5), envelopes(5), qmail-local(8)
  61.  
  62.  
  63.  
  64.                                                                 1
  65.  
  66.  
  67.